package com.xyy.service;

import org.springframework.web.multipart.MultipartFile;

/**
 * 文件服务接口 - 文件路径版本
 */
public interface FileService {

    /**
     * 上传头像文件并返回文件路径
     * @param file 上传的文件
     * @return 文件路径
     */
    String uploadAvatar(MultipartFile file);

    /**
     * 验证是否为有效的图片文件
     * @param file 上传的文件
     * @return 是否有效
     */
    boolean isValidImage(MultipartFile file);

    /**
     * 上传文件并返回文件路径
     * @param fileBytes 文件字节数组
     * @param filename 文件名
     * @param folder 文件夹名称
     * @return 文件路径
     */
    String uploadFile(byte[] fileBytes, String filename, String folder);

    /**
     * 上传活动封面并返回文件路径
     * @param file 上传的文件
     * @return 文件路径
     */
    String uploadCover(MultipartFile file);

    /**
     * 删除文件
     * @param filePath 文件路径
     * @return 是否删除成功
     */
    boolean deleteFile(String filePath);

    /**
     * 获取文件完整路径
     * @param filePath 相对路径
     * @return 完整路径
     */
    String getFullPath(String filePath);
} 